Function            Compaq386GetCpuSpeed - get cpu speed on a
                                               Compaq 386

  Syntax              unsigned char Compaq386GetCpuSpeed(unsigned int
                                                           *speedvalue);

  Prototype in        ibm.h

  Remarks             determines the cpu speed of a Compaq 386 computer.
                      The speed is returned and, if type/category 0x09
                      (dynamic) the parameter speedvalue will point to
                      the direct speed value.

  Return value        returns the cpu speed type/category. See
                      Compaq386SetCpuSpeed() for the list of
                      types/categories.

  Note                This function should ONLY be used on Compaq 386
                      computers or unpredictable results may occur.

  See also            Compaq386KbdType(), Compaq386SetCpuSpeed()

  Example             #include <ibm.h>

                      main()
                      {
                           unsigned char speed;
                           unsigned int directvalue;

                           speed = Compaq386GetCpuSpeed(&directvalue);
                           printf("cpu speed = %u\n",speed);
                           if (directvalue == 0x09)
                                printf("direct value = %u\n",
                                       directvalue);
                      }